package com.dms.modules.product.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.dms.modules.product.entity.ProductCategory;
import com.dms.modules.product.entity.Product;

import java.util.List;

/**
 * 商品分类服务接口
 */
public interface ProductCategoryService extends IService<ProductCategory> {
    
    /**
     * 获取分类列表
     * @param parentId 父分类ID，为null时获取所有一级分类
     * @return 分类列表
     */
    List<ProductCategory> getCategoryList(Long parentId);
    
    /**
     * 获取分类树形结构
     * @return 分类树
     */
    List<ProductCategory> getCategoryTree();
    
    /**
     * 获取子分类列表
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<ProductCategory> getChildren(Long parentId);
    
    /**
     * 获取次元分类
     * @param dimension 次元
     * @return 分类列表
     */
    List<ProductCategory> getDimensionCategories(String dimension);
    
    /**
     * 获取分类的所有子分类ID（包含自身）
     * @param categoryId 分类ID
     * @return 分类ID列表
     */
    List<Long> getCategoryAndChildrenIds(Long categoryId);
    
    /**
     * 添加分类
     * @param category 分类信息
     */
    void addCategory(ProductCategory category);
    
    /**
     * 更新分类
     * @param category 分类信息
     */
    void updateCategory(ProductCategory category);
    
    /**
     * 删除分类
     * @param categoryId 分类ID
     */
    void deleteCategory(Long categoryId);
    
    /**
     * 更新分类显示状态
     * @param categoryId 分类ID
     * @param visible 是否显示
     */
    void updateVisible(Long categoryId, Integer visible);
    
    /**
     * 获取分类商品列表
     * @param categoryId 分类ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 商品分页列表
     */
    IPage<Product> getCategoryProducts(Long categoryId, Integer pageNum, Integer pageSize);
    
    /**
     * 根据维度获取分类列表
     * @param dimension 维度（一次元、二次元、三次元）
     * @return 分类列表
     */
    List<ProductCategory> getCategoriesByDimension(String dimension);
    
    /**
     * 获取多级分类筛选的商品列表
     * @param categoryIds 分类ID列表（按层级顺序）
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 商品分页列表
     */
    IPage<Product> getFilteredCategoryProducts(List<Long> categoryIds, Integer pageNum, Integer pageSize);

    /**
     * 分页查询分类
     *
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @param name 分类名称（可选）
     * @return 分页结果
     */
    Page<ProductCategory> pageCategories(Integer pageNum, Integer pageSize, String name);

    /**
     * 检查分类下是否有商品
     *
     * @param categoryId 分类ID
     * @return 是否有商品
     */
    boolean hasProducts(Long categoryId);
} 